-------------------------------------------------------------------
 Vinyl Goddess From Mars music converter - version 1.0 (2007-06-24)
 Written by Adam Nielsen (malvineous@shikadi.net)
 http://www.shikadi.net/utils/
-------------------------------------------------------------------

// What is it?
////////////////

Vinyl2CMF converts music from the game "Vinyl Goddess From Mars" into Creative
Labs' CMF music format.  There are many utilities and players for CMF files,
so the music is much easier to work with once it's in this format.

// Usage
//////////

  Linux:      $ vinyl2cmf 121 197 title.cmf

  DOS:      C:\>vinl2cmf 121 197 title.cmf

121 and 197 are filenames in the current directory, which have been extracted
from GODDESS.LBR (see below.)  The first filename (121) is the music file,
and the second filename (197) is the instrument file.  There is no easy way to
find out what these are, other than opening them in a binary editor and
comparing them (I recommend "List" by Vernon Buerg as it has full 8-bit ASCII
display.)

There is a "convert all" script included in this distribution that converts
all files from (I think) the registered version of Vinyl you could use as a
starting point.

// GODDESS.LBR
////////////////

At this point Vinyl2CMF doesn't read directly from the .LBR file, so you'll
need to extract its contents into the current directory.  For this I use
Frenkel Smeijers' Vgfmext available from http://www.sfprod.tk/ or direct at
http://www.student.tue.nl/p/f.a.m.smeijers/sfp/games/vinyl.htm

The shareware version of "List" can be download from http://www.buerg.com/

// Limitations
////////////////

The CMF file created by Vinyl2CMF uses a custom MIDI controller to disable the
standard CMF AM+VIB depth extension.  If you use a player that doesn't support
this controller (i.e. all of them except the one I wrote) the instruments
won't sound 100% accurate.

I have written a patch for AdPlug, which will hopefully make it into the main
distribution soon (as of 2008-09-13), so that AdPlug can be used to play these
files too.

// Contact
////////////

Source code is available at http://www.shikadi.net/utils/

You can e-mail me at malvineous@shikadi.net

I have documented all the file formats (CMF, Vinyl Music, Vinyl Instruments) on
the Game Modding Wiki: http://www.shikadi.net/moddingwiki/

Enjoy!
